home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / BRODIE / GOPHERD_ / !GopherD / ReadMe1st < prev   
Text File  |  1995-10-06  |  5KB  |  133 lines
  1. !GopherD
  2. ========
  3.  
  4. Contents:
  5.     Legal Declaration
  6.     How to structure a gopher database
  7.     How to write a gopher menu
  8.     How to edit the top level menu
  9.     How to browser your gopher database with ArcWeb
  10.     
  11.  
  12. Legal Declaration
  13. =================
  14.  
  15. In the legal declaration below, "This Product" is defined to be all the
  16. files within the original archive.
  17.  
  18. "the author" is Stewart Brodie (S.N.Brodie@ecs.southampton.ac.uk)
  19.  
  20. Copyright of the product remains with the author.
  21.  
  22. This version of this product is 'freeware'.  My definition of 'freeware': 
  23. This means that the author retains copyright over the product, but allows
  24. unlimited distribution except:
  25.  
  26.  
  27.    i) No charge must be made (except for a nominal fee for distribution media)
  28.   ii) This Product must be distributed as a complete package
  29.  iii) This Product may not be distributed as part of a non-free
  30.       [free as in (i)] package (of any kind, magazine/hardware/software)
  31.       without prior written consent from the author
  32.       authors.
  33.   iv) If any further distribution occurs compliant with all of the above,
  34.       credit must be clearly given to the author
  35.  
  36. This version may NOT be freely uploaded to FTP sites currently, because
  37. it does not handle everything yet, and will be upgraded to do so soon.
  38.  
  39. No liability whatsoever is accepted by the author of this product for losses
  40. or damage of any kind at all arising, or allegedly arising, from the use, or
  41. misuse, of This Product.  You are hereby warned that any costs incurred
  42. through the use of this package over a non-free networking medium are the
  43. sole responsibility of the user.
  44.  
  45. The author does not guarantee the functionality of the package, and does not
  46. guarantee to fix any reported bugs, although the author will investigate bug
  47. reports and may release new versions.
  48.  
  49.  
  50. How to structure a gopher database
  51. ==================================
  52.  
  53. Gopher objects have a (single ASCII character) type associated with them.  It
  54. is conventional to create a subdirectory for each type and place the objects
  55. inthese subdirectories, sorted by type, although it is not a requirement of
  56. the gopher protocol.
  57.  
  58. Gopher databases usually have hierarchies of menus 
  59.  
  60.  
  61. How to write a gopher menu
  62. ==========================
  63.  
  64. Gopher menus have each entry on its own line.  You will need a text editor
  65. which preserves TAB characters!   The format of a menu line is:
  66.  
  67. typeDescriptionTABselectorTABhostnameTABport
  68.  
  69. where:
  70.   * type is the single ASCII type character (see below)
  71.   * Description is the user-visible name of the object
  72.   * selector is the opaque selector to retrieve the object
  73.   * hostname is the gopher host where this object is
  74.   * port is the TCP port number on which the gopher server resides on hostname
  75.   * TAB is a single byte ASCII 9 character.
  76.  
  77. Main type bytes are: (see RFC1436 for a list) [Note: there are duplicates
  78. in the list - you should use the alphabetic character version in preference
  79. to any punctuation character]
  80.  
  81. 0  text document [Note: this is ASCII character 48, not ASCII NUL]
  82. 1  gopher menu
  83. 7  searchable index (not implemented in current version of !gopherd)
  84. 8  telnet
  85. 9  binary file
  86. g  GIF
  87. H  HTML
  88. h  HTML 
  89. I  image
  90. ;  movie
  91. <  sound
  92. s  sound
  93.  
  94. End the menu by having a single . character on a line on its own.
  95.  
  96. Note that the 'selector' is completely opaque to any client (ie. it
  97. mustn't parse it).  It will be sent as is to the server, or a web
  98. client will convert it into a hyperlink reference as:
  99. gopher://host:port/selector
  100.  
  101. There is no concept of relative filenames.
  102.  
  103.     
  104. How to edit the top level menu
  105. ==============================
  106.  
  107. Edit the menu in !GopherD.gopher_top
  108.  
  109.  
  110. How to browser your gopher database with ArcWeb
  111. ===============================================
  112.  
  113. You can browse your new gopher database with any web browser which 
  114. supports gopher either natively (like ArcWeb 0.37 and later) or
  115. via a proxy.  The URL for the top level menu of the server is
  116. just:  gopher://host.domain/   where host.domain is your machine
  117. name.  In reality, the URL should be gopher://host.domain/1 indicating
  118. that it is a menu, but web browsers assume this.  The 1  ^^^ is the
  119. gopher type byte.  It is used by the web browser to predetermine the
  120. type of object which it is downloading and is NOT passed to the gopher
  121. server at all.
  122.  
  123. eg. To get my GIF from the supplied sample setup, you would have a URL:
  124. gopher://host.domain/gg/stewart.gif
  125. The client sends to the server:   g/stewart.gif
  126. and the server sends <gopher$base>.g.stewart/gif
  127.  
  128. The web client would ASSUME that the object was a GIF based on the
  129. first g in the URL, although it may check the returned object to
  130. confirm that.
  131.  
  132. ==END==
  133.